健康活动摘要（HealthActivitySummary）#

HealthActivitySummary 类用于访问用户每日健康活动的汇总数据，包括活跃能量消耗、锻炼时间、站立小时数等。该类支持不同的移动模式（如消耗能量或移动时间），可用于显示活动圆环的进度或生成自定义的健康日报表。

使用场景#

• 展示每日 Apple 活动圆环（移动、锻炼、站立）进度
• 比较用户每日活动与其设定的目标
• 构建自定义健康看板或健身追踪 UI
• 提供趋势分析或活动达成提醒功能

类：HealthActivitySummary#

属性#

方法#

以下方法都返回指定单位下的数值（HealthUnit），表示当前日期的实际数据或目标值：

activeEnergyBurned(unit: HealthUnit): number#

返回当天的活跃能量消耗（例如千卡），适用于 activeEnergy 移动模式。

activeEnergyBurnedGoal(unit: HealthUnit): number#

返回当天的活跃能量目标值（例如千卡），仅在 activityMoveMode 为 activeEnergy 时有效。

appleMoveTime(unit: HealthUnit): number#

返回 Apple Watch 记录的当天移动时间（单位通常为分钟），适用于 appleMoveTime 移动模式。

appleMoveTimeGoal(unit: HealthUnit): number#

返回当天的移动时间目标，仅在 activityMoveMode 为 appleMoveTime 时有效。

appleExerciseTime(unit: HealthUnit): number#

返回当天的锻炼时间总长，通常以分钟为单位。

appleExerciseTimeGoal(unit: HealthUnit): number#

返回当天的锻炼时间目标。

appleStandHours(unit: HealthUnit): number#

返回当天站立小时数（即每小时至少活动1分钟的小时数）。

appleStandHoursGoal(unit: HealthUnit): number#

返回当天的站立目标小时数（通常为12小时）。

示例用法#

1async function showTodaySummary() {
2  const startDate = new Date()
3  startDate.setHours(0, 0, 0, 0)
4
5  const start = DateComponents.fromDate(startDate)
6  const end = DateComponents.fromDate(startDate)
7  end.date += 1
8
9  const summaries = await Health.queryActivitySummaries({
10    start, // today
11    end,
12  })
13
14  if (summaries.length === 0) {
15    console.log('今天暂无活动摘要')
16    return
17  }
18
19  const summary = summaries[0]
20
21  console.log('日期:', summary.dateComponents)
22  console.log('移动模式:', summary.activityMoveMode)
23
24  const kcal = summary.activeEnergyBurned(HealthUnit.kilocalorie())
25  const kcalGoal = summary.activeEnergyBurnedGoal(HealthUnit.kilocalorie())
26
27  console.log(`活跃能量消耗: ${kcal} / ${kcalGoal} 千卡`)
28  console.log(`锻炼时间: ${summary.appleExerciseTime(HealthUnit.minute())} 分钟`)
29  console.log(`站立小时数: ${summary.appleStandHours(HealthUnit.count())} 小时`)
30}

注意事项#

• HealthActivitySummary 表示单日的活动摘要，若需趋势分析需查询多个摘要。
• 不同用户可能启用了不同的移动目标模式：基于能量或移动时间。
• HealthUnit 必须匹配目标字段类型。例如时间应使用 minute() 或 second()，计数使用 count()。
• 可搭配 Health.queryActivitySummaries() 方法查询指定日期范围内的摘要数组。